home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_STL.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  4.8 KB  |  96 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-STL
  3. .SH NAME
  4. imp_stl \- StereoLithography STL geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the StereoLithography STL
  8. geometry import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a StereoLithography STL file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i stl -o wave filename.stl
  16. .PP
  17. To convert a StereoLithography STL file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i stl -in-stl-flip-axes = yes -o vrml filename.stl
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This geometry import converter reads both binary and ASCII versions of 
  25. StereoLithography STL files which are typically sent to 3D System's 
  26. StereoLithography molding machine. All triangles are read into a single 
  27. object since there is no object information contained within a .stl file.
  28. .PP
  29. .SH COMMAND LINE OPTIONS
  30. .PP
  31. The following options are specific to this import converter:
  32. .TP
  33. -i stl
  34. This is the optional command line option which specifies that the input data
  35. is in the StereoLithography STL file format (ASCII or binary). If not 
  36. specified then the converter will try to guess the input file's format from 
  37. its file extension (.stl) and then from the contents of its file. 
  38. .TP
  39. -in-stl-report-statistics = [ yes | no ]
  40. If this option is enabled then the import converter will print out the number 
  41. of objects and polygons that were parsed from the file.
  42. .TP
  43. -in-stl-weld-vertices = [ yes | no ]
  44. Polygons read in from a .stl file are, by nature, completely separate from 
  45. each other and do not share vertices even if two adjacent polygons are 
  46. situated side by side. This is quite inefficient and also it will not allow 
  47. the .stl data to be "smoothed" out using the smoothing option described below. 
  48. To overcome these problems the "Welding" option can be enabled. Vertex welding 
  49. collapses adjacent vertices which are within a distance less than or equal to 
  50. the threshold value specified with the '-in-stl-vertices-threshold' option.
  51. This welding operation should be performed if the "-in-stl-compute-normals"
  52. option (see below) is enabled. Also, the welding operation can become quite 
  53. slow for objects with large number of vertices since every vertex must be 
  54. compared against every other vertex (an n-squared problem). This option is 
  55. enabled by default. 
  56. .TP
  57. -in-stl-vertices-threshold = <threshold value>
  58. If the distance between two vertices is less than or equal to this number, 
  59. and the "-in-stl-weld-vertices" option is enabled then the two vertices will 
  60. be collapsed (welded) into one. Since no edge in a .stl file should be 
  61. shorter than 0.00015 units, the minimum value for this threshold value should 
  62. be set to 0.00015 (which is the default).
  63. .TP
  64. -in-stl-compute-normals = [ yes | no ]
  65. All .stl files do not contain vertex normals and thus will not look smooth 
  66. when shaded. This option, when enabled, will allow smoothed vertex normals to 
  67. be computed for the data based on the angle between adjacent polygons. The 
  68. smoothing criterion is based on the angle between adjacent polygons; common 
  69. smoothed vertex normals will be computed if the angle between their geometric 
  70. surfaces normals is less than the "-in-stl-smoothing-angle" type-in value described 
  71. below. If this checkbox is disabled then no new vertex 
  72. normals will be created. NOTE: for this option to work properly the input data 
  73. must have its vertices welded together so that adjacent polygons share the 
  74. same vertices (the "-in-stl-weld-vertices" option must be enabled. This 
  75. option is enabled by default. 
  76. .TP
  77. -in-stl-smoothing-angle    = <smoothing angle in degrees>
  78. This type-in value sets the cut-off smoothing angle (in degrees) used by 
  79. the vertex normal computation algorithm. If the angle between two adjacent 
  80. polygons is greater than this number then no smoothing will occur (a crease 
  81. will be evident between the two polygons), else smoothing will occur where 
  82. the polygons meet. The default angle is 45 degrees; higher values will make 
  83. the surface smoother.
  84. .TP
  85. -in-stl-flip-axes = [ yes | no ]
  86. If this option is enabled then the model will be reorientated so that the 
  87. "Up" axis of the model will be aligned with the positive Y axis (which is 
  88. used by the converter) instead of the positive "Z" axis as used by .stl 
  89. files. This option should be enabled by default.
  90. .TP
  91. -in-stl-reverse-poly-orientation = [ yes | no ]
  92. If this option is enabled then the orientation of each polygon will be 
  93. reversed so that the polygons' normals point in the opposite direction. 
  94. By default this option is disabled ('no').
  95.  
  96.